home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / gen / cm / cm100.doc < prev    next >
Text File  |  1992-07-14  |  3KB  |  85 lines
  1. ┌──────────────────────────────────────────────────────────────────────────────┐
  2. │ CircleMaster (CM) v1.00                                                      │
  3. │ Copyright (C) 1992                                                           │
  4. │ By Truman Brown                                                              │
  5. └──────────────────────────────────────────────────────────────────────────────┘
  6.  
  7. CIRCLEMASTER:
  8.  
  9. CircleMaster is a data file generator for the Persistence of Vision Raytracer
  10. (POVRay).  For information about raytracing, POVRay, computer generated art,
  11. or other utilities supporting the art of raytracing please visit the Computer
  12. Art forum on CompuServe (tm) [GO COMART].
  13.  
  14. RESTRICTIONS AND DISCLAIMERS:
  15.  
  16. CircleMaster (CM) is freely distributable.  The author retains the copyright to
  17. the program, but authorizes free distribution by BBS'es, networks, magnetic media,
  18. etc.  The distributor may charge no more than five dollars ($5) U.S. for this
  19. software.
  20.  
  21. CM may not be used as part of any commercial package without the explicit written
  22. consent of the author - Truman Brown.
  23.  
  24. The author makes no guarantees or warranties with this program and claims no
  25. responsibility for any damage or loss of time caused by this program.
  26.  
  27. DESCRIPTION:
  28.  
  29. CircleMaster enables you to create exacting specifications for quadric spheres,
  30. quadric ellipsoids, and intersections thereof.
  31.  
  32. Ever needed an ellipse with a width radius of 5.5, a height radius of 3.5, and you
  33. also needed to know where to intersect a plane on it such that the ensuing radius
  34. at the intersection was exactly 1.0?  Now you can.
  35.  
  36. SYNTAX:
  37.   CM /A# /B# /ofilename [options]
  38.      /A# or /X# = radius of major axis [default = 1.0]
  39.      /B# or /Y# = radius of minor axis [default = 1.0]
  40.      /ofilename = name of output file to write data to
  41.  
  42.      Options:
  43.      /r#          = specified radius of an intersection
  44.      /p1          = write output in PoV 1.0 syntax
  45.      /t#          = desired tangent angle
  46.      /c           = use clip_by instead of intersection
  47.      /ns          = don't include statistical summary
  48.      /nb          = don't include bounding by sphere
  49.      /nobjectname = specify a name for the object
  50.  
  51. EXAMPLES:
  52.   Specify a sphere with radius 5 in PoVRAY beta 0.51 syntax:
  53.      CM X5 Y5 OSPHERE.INC
  54.  
  55.   Specify an ellipsoid with an X radius of 6 and a Y radius of 3 using
  56.   PoVRAY 1.0 syntax:
  57.      CM A 6 B 3 o test.inc p1
  58.  
  59.   Specify an ellipsoid with an X radius of 10, intersected with a plane at
  60.   a point such that the intersection point has a tangent angle of 45 degrees,
  61.   and the radius of the intersection is 5:
  62.      CM A 10 T45 Oorb.inc r5
  63.  
  64.   Specify a sphere with a radius of 6, intersected with a plane at a point
  65.   where the radius of the intersection is 4, and name the object MYORB:
  66.      CM X 6 B 6 R 4 NMYORB Ooutput.inc
  67.  
  68.   That's the basics.  You can play around with the other parameters -- they are
  69.   pretty much self-explainatory.
  70.  
  71. NOTES:
  72.   The value of X (or A) must be greater than or equal to Y (or B).
  73.  
  74.   If you use the /T parameter, it will override the value of Y (or B).
  75.   For now, using the /T parameter is the only "easy" way of obtaining
  76.   a shape with a Y value that is greater than the X value.
  77.  
  78.   Watch for HYPE -- CM's companion program.
  79.  
  80. CREDITS:
  81.   I wish to thank:
  82.  
  83.   My wife Madrid for her patience and love.
  84.   Obsessed programmers / trace-aholics can be miserable to live with.
  85.